Assets

Assets are equipment owned by customers.

Get a single asset

GET /assets/{id}

Returns an asset.

Response Attributes

Name	Value
assetType	The vehicle type.
casesURL	The cases URL.
chassisID	The vehicle chassis identifier.
createdAt	The date the record was created.
engine:name	The vehicle engine name.
engineDisplacement	The vehicle engine displacement.
engineHours	The vehicle engine hours.
engineFuel	The vehicle engine fuel.
engineHorsepower	The vehicle engine horse power.
engineMake	The vehicle engine make.
engineSerialNumber	The vehicle engine serial number.
id	The numerical record id.
make:name	The vehicle make name.
mileage	The vehicle mileage.
model:name	The vehicle model name.
owner:name	The vehicle owner name.
recallPending	The vehicle recall pending.
serialNumber	The serial number of the vehicle.
updatedAt	The date the record was last updated.
unitNumber	The vehicle unit number.
URL	The object URL.
VIN	Vehicle Identification Number.
warrantyStartDate	The vehicle warranty start date.
year	The vehicle year.

Response

<?xml version="1.0" encoding="UTF-8"?>
<asset xmlns="http://www.decisiv.net/platform_api/0.3-beta/Case/AssetResponse"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xsi:schemaLocation="http://www.decisiv.net/platform_api/0.3-beta/Case/AssetResponse">
    <URL>URL0</URL>
    <casesURL>casesURL0</casesURL>
    <id>id0</id>
    <VIN>vin0</VIN>
    <serialNumber>serialNumber0</serialNumber>
    <year>year0</year>
    <make>
        <name>name0</name>
    </make>
    <model>
        <name>name1</name>
    </model>
    <engine>
        <name>name2</name>
    </engine>
    <engineDisplacement>engineDisplacement0</engineDisplacement>
    <engineFuel>engineFuel0</engineFuel>
    <engineHorsepower>engineHorsepower0</engineHorsepower>
    <engineMake>engineMake0</engineMake>
    <engineSerialNumber>engineSerialNumber0</engineSerialNumber>
    <owner>
        <name>name3</name>
    </owner>
    <chassisID>chassisID0</chassisID>
    <mileage>0</mileage>
    <engineHours>0</engineHours>
    <unitNumber>unitNumber0</unitNumber>
    <warrantyStartDate>2006-05-04</warrantyStartDate>
    <recallPending>false</recallPending>
    <assetType>assetType0</assetType>
</asset>

List assets

GET /assets

Returns a collection of assets. These results can be filtered using optional parameters.

Query

Filtering

chassis_id, serial_number, unit_number, vin

Sorting

Not supported

Limit

10 results

Response Attributes

See Response Attributes above

Response

<?xml version="1.0" encoding="UTF-8"?>
<assets xmlns="http://www.decisiv.net/platform_api/0.3-beta/Case/AssetResponse"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xmlns:d="http://www.decisiv.net/platform_api/0.3-beta/Case/Department"
 xsi:schemaLocation="http://www.decisiv.net/platform_api/0.3-beta/Case/AssetResponse">
    <asset>
        <URL>URL0</URL>
        <casesURL>casesURL0</casesURL>
        <id>id0</id>
        <VIN>vin0</VIN>
        <serialNumber>serialNumber0</serialNumber>
        <year>year0</year>
        <make>
            <name>name0</name>
        </make>
        <model>
            <name>name1</name>
        </model>
        <engine>
            <name>name2</name>
        </engine>
        <engineDisplacement>engineDisplacement0</engineDisplacement>
        <engineFuel>engineFuel0</engineFuel>
        <engineHorsepower>engineHorsepower0</engineHorsepower>
        <engineMake>engineMake0</engineMake>
        <engineSerialNumber>engineSerialNumber0</engineSerialNumber>
        <owner>
            <name>name3</name>
        </owner>
        <chassisID>chassisID0</chassisID>
        <mileage>0</mileage>
        <engineHours>0</engineHours>
        <unitNumber>unitNumber0</unitNumber>
        <warrantyStartDate>2006-05-04</warrantyStartDate>
        <recallPending>false</recallPending>
        <assetType>assetType0</assetType>
        <department>
          <d:code>code0</d:code>
          <d:description>description0</d:description>
        </department>
    </asset>
    <asset>
        <URL>URL1</URL>
        <casesURL>casesURL1</casesURL>
        <id>id1</id>
        <VIN>vin1</VIN>
        <serialNumber>serialNumber1</serialNumber>
        <year>year1</year>
        <make>
            <name>name4</name>
        </make>
        <model>
            <name>name5</name>
        </model>
        <engine>
            <name>name6</name>
        </engine>
        <engineDisplacement>engineDisplacement1</engineDisplacement>
        <engineFuel>engineFuel1</engineFuel>
        <engineHorsepower>engineHorsepower1</engineHorsepower>
        <engineMake>engineMake1</engineMake>
        <engineSerialNumber>engineSerialNumber1</engineSerialNumber>
        <owner>
            <name>name7</name>
        </owner>
        <chassisID>chassisID1</chassisID>
        <mileage>0</mileage>
        <engineHours>0</engineHours>
        <unitNumber>unitNumber1</unitNumber>
        <warrantyStartDate>2006-05-04</warrantyStartDate>
        <recallPending>false</recallPending>
        <assetType>assetType1</assetType>
        <department>
          <d:code>code1</d:code>
          <d:description>description1</d:description>
        </department>
    </asset>
</assets>

List cases for an asset

GET /assets/{id}/cases

Returns a list of cases.

Query

Filtering

closed, ro_number

Sorting

Records are sorted by created_at in descending order.

Limit

5 results

Response

A list of cases.

Create a case for an asset

Create a case for a fleet or customer asset.

POST /assets/{id}/cases

Request Attributes

Name	Condition	Description
assetArrived	optional	The time at which the asset arrived at the service location.
assetCheckInTime	optional	The time at which the asset was checked in at the service location.
assetDepartedTime	optional	The time at which the asset was departed from the service location.
assetIdentifier:id	optional	The Decisiv Asset Id.
assetInformation:engineHours	optional	The engine hours of the asset when the case is created.
assetInformation:mileage	optional	The mileage of the asset when the case is created.
assetInformation:mileageType	optional	The mileage Type of the asset when the case is created.
assetInformation:trailer:loaded	optional	The status of the trailer.
assetInformation:trailer:unitNumber	optional	The unit number of the trailer attached to the asset.
atr	optional	Actual time of repair.
authNumber	optional	Authorization Number.
breakdown:city	optional	The current location city of the asset.
breakdown:driverName	optional	The driver’s name.
breakdown:driverPhone	optional	The driver’s phone number.
breakdown:location	optional	The current location of the asset.
breakdown:state	optional	The current location state of the asset.
cause	optional	The description of the cause for the case.
complaint	optional	The description of the complaint.
confirmedAppointmentTime	optional	Confirmed appointment time.
correction	optional	The description of the resolution for the case.
customComplaintCodes:code	optional	A set of custom complaint codes (must be defined through Professional Services before use).
customerRequestedAppointmentTime	optional	The customer’s preferred appointment time.
customerRequestedCompletionTime	optional	The customer’s preferred completion time.
customers:billingCustomer:id	optional	The Billing Customer ID.
customers:shippingCustomer:id	optional	The Shipping Customer ID.
department:code	optional	The case department code.
downtime	optional	The time at which the asset was not operational.
etr	optional	Estimated time of repair.
followupTime	optional	The time by which the customer needs to be contacted.
invoiceAmount	optional	Invoice total.
invoiceDate	optional	Invoice Date.
invoiceNumber	optional	Invoice number.
poNumber	optional	Purchase order number.
primaryContact:email	optional	The email of the primary contact.
primaryContact:name	optional	The full name of the primary contact.
primaryContact:phone	optional	The phone number of the primary contact.
primaryContact:relation	optional	The relation of the primary contact.
programType:description	optional	The case program type description.
roNumber	optional	Repair order number.
serviceLocationSuggestedAppointmentTime	optional	Service location’s preferred appointment time.
status:name	optional	Current status of the case.
tagNumber	optional	Tag number for the asset on the lot.
uptime	optional	The time at which the asset was operational.
vmrs:code14	optional	Reason for repair.
vmrs:code15	optional	Work Accomplished.
vmrs:code16	optional	Repair priority.
vmrs:code17	optional	Repair site.
vmrs:code82	optional	Operator Report.
vmrs:complaintCode33	optional	Component code for the complaint.
vmrs:complaintCode79	optional	Position code for the complaint.
vmrs:correctionCode33	optional	Component code for the correction.
vmrs:correctionCode79	optional	Position code for the correction.

Request

<?xml version="1.0" encoding="UTF-8"?>
<case xmlns="http://www.decisiv.net/platform_api/0.3-beta/Case/CaseRequest"
      xmlns:ct="http://www.decisiv.net/platform_api/0.3-beta/Case/CaseTypes"
      xmlns:g="http://www.decisiv.net/platform_api/0.2/Case/GroupedUser"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xmlns:d="http://www.decisiv.net/platform_api/0.3-beta/Case/Department"
      xmlns:pt="http://www.decisiv.net/platform_api/0.3-beta/Case/ProgramType"
      xsi:schemaLocation="http://www.decisiv.net/platform_api/0.3-beta/Case/CaseRequest">
    <assignee>
        <g:id>id0</g:id>
    </assignee>
    <primaryContact>
        <ct:name>name0</ct:name>
        <ct:phone>15558675309</ct:phone>
        <ct:email>email0</ct:email>
        <ct:relation>relation0</ct:relation>
    </primaryContact>
    <breakdown>
        <ct:driverName>driver name</ct:driverName>
        <ct:driverPhone>555-555-5555</ct:driverPhone>
        <ct:location>location0</ct:location>
        <ct:city>city0</ct:city>
        <ct:state>state0</ct:state>
    </breakdown>
    <assetDepartedTime>2006-05-04T18:13:51.0</assetDepartedTime>
    <assetInformation>
      <ct:engineHours>engineHours0</ct:engineHours>
      <ct:mileage>100</ct:mileage>
      <ct:mileageType>mi</ct:mileageType>
      <ct:trailer>
        <ct:unitNumber>unitNumber</ct:unitNumber>
        <ct:loaded>true</ct:loaded>
      </ct:trailer>
    </assetInformation>
    <cause>cause0</cause>
    <correction>correction0</correction>
    <complaint>complaint0</complaint>
    <downtime>2006-05-04T18:13:51.0</downtime>
    <uptime>2006-05-04T18:13:51.0</uptime>
    <customerRequestedAppointmentTime>2006-05-04T18:13:51.0</customerRequestedAppointmentTime>
    <serviceLocationSuggestedAppointmentTime>2006-05-04T18:13:51.0</serviceLocationSuggestedAppointmentTime>
    <confirmedAppointmentTime>2006-05-04T18:13:51.0</confirmedAppointmentTime>
    <customerRequestedCompletionTime>2006-05-04T18:13:51.0</customerRequestedCompletionTime>
    <followupTime>2006-05-04T18:13:51.0</followupTime>
    <assetArrived>2006-05-04T18:13:51.0</assetArrived>
    <assetCheckInTime>2006-05-04T18:13:51.0</assetCheckInTime>
    <etr>2006-05-04T18:13:51.0</etr>
    <atr>2006-05-04T18:13:51.0</atr>
    <poNumber>poNumber0</poNumber>
    <roNumber>roNumber0</roNumber>
    <invoiceAmount>0.00</invoiceAmount>
    <invoiceNumber>invoiceNumber0</invoiceNumber>
    <authNumber>authNumber0</authNumber>
    <tagNumber>tagNumber0</tagNumber>
    <department>
        <d:code>code0</d:code>
    </department>
    <programType>
      <pt:description>description0</pt:description>
    </programType>
    <customers>
      <billingCustomer>
        <ct:id>billingCustomer0</ct:id>
      </billingCustomer>
      <shippingCustomer>
        <ct:id>shippingCustomer0</ct:id>
      </shippingCustomer>
    </customers>
</case>

Response

A single case response.